综合应用 —— 名片管理系统

目标

综合应用已经学习过的知识点：

变量
流程控制
函数
模块

开发 名片管理系统

系统需求

1. 程序启动，显示名片管理系统欢迎界面，并显示功能菜单

 
x
**************************************************
欢迎使用【名片管理系统】V1.0
1. 新建名片
2. 显示全部
3. 查询名片
0. 退出系统
**************************************************

1. 用户用数字选择不同的功能
1. 根据功能选择，执行不同的功能
1. 用户名片需要记录用户的姓名、电话、QQ、邮件
1. 如果查询到指定的名片，用户可以选择修改或者删除名片

步骤

框架搭建
新增名片
显示所有名片
查询名片
查询成功后修改、删除名片
让 Python 程序能够直接运行

01. 框架搭建

目标

搭建名片管理系统 框架结构
1. 准备文件，确定文件名，保证能够 在需要的位置 编写代码
2. 编写 主运行循环，实现基本的 用户输入和判断

1.1 文件准备

新建 cards_main.py 保存 主程序功能代码
- 程序的入口
- 每一次启动名片管理系统都通过 main 这个文件启动
新建 cards_tools.py 保存 所有名片功能函数
- 将对名片的新增、查询、修改、删除等功能封装在不同的函数中

1.2 编写主运行循环

在 cards_main 中添加一个 无限循环

 
xxxxxxxxxx
while True:
    # TODO(小明) 显示系统菜单
    action = input("请选择操作功能：")
    print("您选择的操作是：%s" % action)
    # 根据用户输入决定后续的操作
    if action in ["1", "2", "3"]:
        pass
    elif action == "0":
        print("欢迎再次使用【名片管理系统】")
        break
    else:
        print("输入错误，请重新输入")

字符串判断

 
xxxxxxxxxx
if action in ["1", "2", "3"]:

 
xxxxxxxxxx
if action == "1" or action == "2" or action == "3":

使用 in 针对列表判断，避免使用 or 拼接复杂的逻辑条件
没有使用 int 转换用户输入，可以避免 一旦用户输入的不是数字，导致程序运行出错

pass

pass 就是一个空语句，不做任何事情，一般用做占位语句
是为了保持程序结构的完整性

无限循环

在开发软件时，如果 不希望程序执行后 立即退出
可以在程序中增加一个 无限循环
由用户来决定 退出程序的时机

TODO 注释

在 # 后跟上 TODO，用于标记需要去做的工作

 
xxxxxxxxxx
# TODO(作者/邮件) 显示系统菜单

1.3 在 `cards_tools` 中增加四个新函数

 
xxxxxxxxxx
def show_menu():
    """显示菜单
    """
    pass
def new_card():
    """新建名片
    """
    print("-" * 50)
    print("功能：新建名片")
def show_all():
    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")
def search_card():
    """搜索名片
    """
    print("-" * 50)
    print("功能：搜索名片")

1.4 导入模块

在 cards_main.py 中使用 import 导入 cards_tools 模块

 
xxxxxxxxxx
import cards_tools

修改 while 循环的代码如下：

 
xxxxxxxxxx
import cards_tools
while True:
    cards_tools.show_menu()
    action = input("请选择操作功能：")
    print("您选择的操作是：%s" % action)
    # 根据用户输入决定后续的操作
    if action in ["1", "2", "3"]:
        if action == "1":
            cards_tools.new_card()
        elif action == "2":
            cards_tools.show_all()
        elif action == "3":
            cards_tools.search_card()
    elif action == "0":
        print("欢迎再次使用【名片管理系统】")
        break
    else:
        print("输入错误，请重新输入：")

至此：cards_main 中的所有代码全部开发完毕！

1.5 完成 `show_menu` 函数

 
xxxxxxxxxx
def show_menu():
    """显示菜单
    """
    print("*" * 50)
    print("欢迎使用【菜单管理系统】V1.0")
    print("")
    print("1. 新建名片")
    print("2. 显示全部")
    print("3. 查询名片")
    print("")
    print("0. 退出系统")
    print("*" * 50)

02. 保存名片数据的结构

程序就是用来处理数据的，而变量就是用来存储数据的

使用字典记录 每一张名片 的详细信息
使用列表统一记录所有的 名片字典

001_名片管理系统全局列表-w500

定义名片列表变量

在 cards_tools 文件的顶部增加一个 列表变量

 
xxxxxxxxxx
# 所有名片记录的列表
card_list = []

注意

所有名片相关操作，都需要使用这个列表，所以应该 定义在程序的顶部
程序刚运行时，没有数据，所以是 空列表

03. 新增名片

3.1 功能分析

提示用户依次输入名片信息
将名片信息保存到一个字典
将字典添加到名片列表
提示名片添加完成

3.2 实现 new_card 方法

根据步骤实现代码

 
xxxxxxxxxx
def new_card():
    """新建名片
    """
    print("-" * 50)
    print("功能：新建名片")
    # 1. 提示用户输入名片信息
    name = input("请输入姓名：")
    phone = input("请输入电话：")
    qq = input("请输入 QQ 号码：")
    email = input("请输入邮箱：")
    # 2. 将用户信息保存到一个字典
    card_dict = {"name": name,
                 "phone": phone,
                 "qq": qq,
                 "email": email}
    # 3. 将用户字典添加到名片列表
    card_list.append(card_dict)
    print(card_list)
    
    # 4. 提示添加成功信息
    print("成功添加 %s 的名片" % card_dict["name"])

技巧：在 PyCharm 中，可以使用 SHIFT + F6 统一修改变量名

04. 显示所有名片

4.1 功能分析

循环遍历名片列表，顺序显示每一个字典的信息

4.2 基础代码实现

 
xxxxxxxxxx
def show_all():
    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")
    for card_dict in card_list:
        print(card_dict)

显示效果不好！

4.3 增加标题和使用 `\t` 显示

 
xxxxxxxxxx
def show_all():
    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")
    # 打印表头
    for name in ["姓名", "电话", "QQ", "邮箱"]:
        print(name, end="\t\t")
    print("")
    # 打印分隔线
    print("=" * 50)
    for card_dict in card_list:
        print("%s\t\t%s\t\t%s\t\t%s" % (card_dict["name"],
                                        card_dict["phone"],
                                        card_dict["qq"],
                                        card_dict["email"]))

4.4 增加没有名片记录判断

 
xxxxxxxxxx
def show_all():
    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")
    # 1. 判断是否有名片记录
    if len(card_list) == 0:
        print("提示：没有任何名片记录")
        return

注意

在函数中使用 return 表示返回
如果在 return 后没有跟任何内容，只是表示该函数执行到此就不再执行后续的代码

05. 查询名片

5.1 功能分析

提示用户要搜索的姓名
根据用户输入的姓名遍历列表
搜索到指定的名片后，再执行后续的操作

5.2 代码实现

查询功能实现

 
xxxxxxxxxx
def search_card():
    """搜索名片
    """
    print("-" * 50)
    print("功能：搜索名片")
    # 1. 提示要搜索的姓名
    find_name = input("请输入要搜索的姓名：")
    # 2. 遍历字典
    for card_dict in card_list:
        if card_dict["name"] == find_name:
            print("姓名\t\t\t电话\t\t\tQQ\t\t\t邮箱")
            print("-" * 40)
            
            print("%s\t\t\t%s\t\t\t%s\t\t\t%s" % (
                card_dict["name"],
                card_dict["phone"],
                card_dict["qq"],
                card_dict["email"]))
            print("-" * 40)
            
            # TODO(小明) 针对找到的字典进行后续操作：修改/删除
            break
    else:
        print("没有找到 %s" % find_name)

增加名片操作函数：修改/删除/返回主菜单

 
xxxxxxxxxx
def deal_card(find_dict):
    """操作搜索到的名片字典
    :param find_dict:找到的名片字典
    """
    print(find_dict)
    action_str = input("请选择要执行的操作 "
                       "[1] 修改 [2] 删除 [0] 返回上级菜单")
    if action == "1":
        print("修改")
    elif action == "2":
        print("删除")

06. 修改和删除

6.1 查询成功后删除名片

由于找到的字典记录已经在列表中保存
要删除名片记录，只需要把列表中对应的字典删除即可

 
xxxxxxxxxx
    elif action == "2":
        card_list.remove(find_dict)
        print("删除成功")

6.2 修改名片

由于找到的字典记录已经在列表中保存
要修改名片记录，只需要把列表中对应的字典中每一个键值对的数据修改即可

 
xxxxxxxxxx
    if action == "1":
        find_dict["name"] = input("请输入姓名：")
        find_dict["phone"] = input("请输入电话：")
        find_dict["qq"] = input("请输入QQ：")
        find_dict["email"] = input("请输入邮件：")
        print("%s 的名片修改成功" % find_dict["name"])

修改名片细化

如果用户在使用时，某些名片内容并不想修改，应该如何做呢？—— 既然系统提供的 input 函数不能满足需求，那么就新定义一个函数 input_card_info 对系统的 input 函数进行扩展

 
xxxxxxxxxx
def input_card_info(dict_value, tip_message):
    """输入名片信息
    :param dict_value: 字典原有值
    :param tip_message: 输入提示信息
    :return: 如果输入，返回输入内容，否则返回字典原有值
    """
    # 1. 提示用户输入内容
    result_str = input(tip_message)
    # 2. 针对用户的输入进行判断，如果用户输入了内容，直接返回结果
    if len(result_str) > 0:
        return result_str
    # 3. 如果用户没有输入内容，返回 `字典中原有的值`
    else:
        return dict_value

07. LINUX 上的 `Shebang` 符号(`#!`)

#!这个符号叫做 Shebang 或者 Sha-bang
Shebang 通常在 Unix 系统脚本的中 第一行开头 使用
指明 执行这个脚本文件 的 解释程序

使用 Shebang 的步骤

1. 使用 which 查询 python3 解释器所在路径

 
xxxxxxxxxx
$ which python3

1. 修改要运行的 主 python 文件，在第一行增加以下内容

 
xxxxxxxxxx
#! /usr/bin/python3

1. 修改 主 python 文件 的文件权限，增加执行权限

 
xxxxxxxxxx
$ chmod +x cards_main.py

1. 在需要时执行程序即可

 
xxxxxxxxxx
./cards_main.py

综合应用 —— 名片管理系统

目标

系统需求

步骤

01. 框架搭建

1.1 文件准备

1.2 编写主运行循环

字符串判断

pass

无限循环

TODO 注释

1.3 在 cards_tools 中增加四个新函数

1.4 导入模块

1.5 完成 show_menu 函数

02. 保存名片数据的结构

定义名片列表变量

03. 新增名片

3.1 功能分析

3.2 实现 new_card 方法

04. 显示所有名片

4.1 功能分析

4.2 基础代码实现

4.3 增加标题和使用 \t 显示

4.4 增加没有名片记录判断

05. 查询名片

5.1 功能分析

5.2 代码实现

06. 修改和删除

6.1 查询成功后删除名片

6.2 修改名片

修改名片细化

07. LINUX 上的 Shebang 符号(#!)

使用 Shebang 的步骤

1.3 在 `cards_tools` 中增加四个新函数

1.5 完成 `show_menu` 函数

4.3 增加标题和使用 `\t` 显示

07. LINUX 上的 `Shebang` 符号(`#!`)